home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringConcatAndFree.z / XmStringConcatAndFree
Text File  |  1998-10-30  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee - A compound string function that
  10.           appends one string to another and frees the original strings
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee(
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssss1111,
  16.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssss2222);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee copies _s_2 to the end of _s_1 and returns
  23.           a copy of the resulting compound string. The original
  24.           strings are freed.  The function will allocate space to hold
  25.           the returned compound string.  The application is
  26.           responsible for managing the allocated space.  The
  27.           application can recover the allocated space by calling
  28.           XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  29.  
  30.           _s_1        Specifies the compound string to which a copy of
  31.                     _s_2 is appended
  32.  
  33.           _s_2        Specifies the compound string that is appended to
  34.                     the end of _s_1
  35.  
  36.           The XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee function works like the
  37.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaatttt function, except that it frees the _s_1 and _s_2
  38.           strings, and is therefore more efficient. You should use
  39.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaattttAAAAnnnnddddFFFFrrrreeeeeeee instead of XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaatttt if you want
  40.           _s_1 and _s_2 to be freed afterwards.
  41.  
  42.      RRRREEEETTTTUUUURRRRNNNN
  43.           Returns a new compound string.
  44.  
  45.      RRRREEEELLLLAAAATTTTEEEEDDDD
  46.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnnccccaaaatttt(3), XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3), and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3).
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.